home *** CD-ROM | disk | FTP | other *** search
/ Power Hacker 2003 / Power_Hacker_2003.iso / Exploit and vulnerability / w00w00 / w00aimexp2 / includes / aim.h < prev    next >
Encoding:
C/C++ Source or Header  |  2002-04-23  |  31.3 KB  |  961 lines
  1. /* 
  2.  * Main libfaim header.  Must be included in client for prototypes/macros.
  3.  *
  4.  * "come on, i turned a chick lesbian; i think this is the hackish equivalent"
  5.  *                                                -- Josh Meyer
  6.  *
  7.  */
  8.  
  9. #ifndef __AIM_H__
  10. #define __AIM_H__
  11.  
  12. #define FAIM_VERSION_MAJOR 0
  13. #define FAIM_VERSION_MINOR 99
  14. #define FAIM_VERSION_MINORMINOR 1
  15.  
  16. #include <faimconfig.h>
  17. #include <aim_cbtypes.h>
  18.  
  19. #include <stdio.h>
  20. #include <string.h>
  21. #include <fcntl.h>
  22. #include <sys/types.h>
  23. #include <stdlib.h>
  24. #include <stdarg.h>
  25. #include <errno.h>
  26. #include <time.h>
  27.  
  28. #ifdef _WIN32
  29. #include <windows.h>
  30. #include <io.h>
  31. #else
  32. #include <sys/time.h>
  33. #include <unistd.h>
  34. #include <netinet/in.h>
  35. #include <sys/socket.h>
  36. #endif
  37.  
  38. /* XXX adjust these based on autoconf-detected platform */
  39. typedef unsigned char fu8_t;
  40. typedef unsigned short fu16_t;
  41. typedef unsigned long fu32_t;
  42. typedef fu32_t aim_snacid_t;
  43. typedef fu16_t flap_seqnum_t;
  44.  
  45. /* Portability stuff (DMP) */
  46.  
  47. #ifdef _WIN32
  48. #define sleep(x) Sleep((x)*1000)
  49. #define snprintf _snprintf /* I'm not sure whats wrong with Microsoft here */
  50. #define close(x) closesocket(x) /* no comment */
  51. #endif
  52.  
  53. #if defined(mach) && defined(__APPLE__)
  54. #define gethostbyname(x) gethostbyname2(x, AF_INET) 
  55. #endif
  56.  
  57. #if defined(_WIN32) || defined(STRICT_ANSI)
  58. #define faim_shortfunc
  59. #else
  60. #define faim_shortfunc inline
  61. #endif
  62.  
  63. #if defined(_WIN32) && !defined(WIN32_STATIC)
  64. /*
  65.  * For a win32 DLL, we define WIN32_INDLL if this file
  66.  * is included while compiling the DLL. If its not 
  67.  * defined (its included in a client app), the symbols
  68.  * will be imported instead of exported.
  69.  */
  70. #ifdef WIN32_INDLL
  71. #define faim_export __declspec(dllexport)
  72. #else 
  73. #define faim_export __declspec(dllimport)
  74. #endif /* WIN32_INDLL */
  75. #define faim_internal
  76. #else
  77. /*
  78.  * Nothing normally needed for unix...
  79.  */
  80. #define faim_export
  81. #define faim_internal
  82. #endif
  83.  
  84. /* 
  85.  * Current Maximum Length for Screen Names (not including NULL) 
  86.  *
  87.  * Currently only names up to 16 characters can be registered
  88.  * however it is aparently legal for them to be larger.
  89.  */
  90. #define MAXSNLEN 32
  91.  
  92. /*
  93.  * Current Maximum Length for Instant Messages
  94.  *
  95.  * This was found basically by experiment, but not wholly
  96.  * accurate experiment.  It should not be regarded
  97.  * as completely correct.  But its a decent approximation.
  98.  *
  99.  * Note that although we can send this much, its impossible
  100.  * for WinAIM clients (up through the latest (4.0.1957)) to
  101.  * send any more than 1kb.  Amaze all your windows friends
  102.  * with utterly oversized instant messages!
  103.  *
  104.  * XXX: the real limit is the total SNAC size at 8192. Fix this.
  105.  * 
  106.  */
  107. #define MAXMSGLEN 7987
  108.  
  109. /*
  110.  * Maximum size of a Buddy Icon.
  111.  */
  112. #define MAXICONLEN 7168
  113. #define AIM_ICONIDENT "AVT1picture.id"
  114.  
  115. /*
  116.  * Current Maximum Length for Chat Room Messages
  117.  *
  118.  * This is actually defined by the protocol to be
  119.  * dynamic, but I have yet to see due cause to 
  120.  * define it dynamically here.  Maybe later.
  121.  *
  122.  */
  123. #define MAXCHATMSGLEN 512
  124.  
  125. /*
  126.  * Standard size of an AIM authorization cookie
  127.  */
  128. #define AIM_COOKIELEN            0x100
  129.  
  130. #define AIM_MD5_STRING "AOL Instant Messenger (SM)"
  131.  
  132. /*
  133.  * Client info.  Filled in by the client and passed
  134.  * in to aim_login().  The information ends up
  135.  * getting passed to OSCAR through the initial
  136.  * login command.
  137.  *
  138.  * XXX: Should this be per-session? -mid
  139.  *
  140.  */
  141. struct client_info_s {
  142.     char clientstring[100]; /* arbitrary size */
  143.     int major;
  144.     int minor;
  145.     int build;
  146.     char country[3];
  147.     char lang[3];
  148.     int major2;
  149.     int minor2;
  150.     long unknown;
  151. };
  152.  
  153. #define AIM_CLIENTINFO_KNOWNGOOD_3_5_1670 { \
  154.     "AOL Instant Messenger (SM), version 3.5.1670/WIN32", \
  155.     0x0003, \
  156.     0x0005, \
  157.     0x0686, \
  158.     "us", \
  159.     "en", \
  160.     0x0004, \
  161.     0x0000, \
  162.     0x0000002a, \
  163. }
  164.  
  165. #define AIM_CLIENTINFO_KNOWNGOOD_4_1_2010 { \
  166.       "AOL Instant Messenger (SM), version 4.1.2010/WIN32", \
  167.       0x0004, \
  168.       0x0001, \
  169.       0x07da, \
  170.       "us", \
  171.       "en", \
  172.       0x0004, \
  173.       0x0000, \
  174.       0x0000004b, \
  175. }
  176.  
  177. /*
  178.  * I would make 4.1.2010 the default, but they seem to have found
  179.  * an alternate way of breaking that one. 
  180.  *
  181.  * 3.5.1670 should work fine, however, you will be subjected to the
  182.  * memory test, which may require you to have a WinAIM binary laying 
  183.  * around. (see login.c::memrequest())
  184.  */
  185. #define AIM_CLIENTINFO_KNOWNGOOD AIM_CLIENTINFO_KNOWNGOOD_3_5_1670
  186.  
  187. #ifndef TRUE
  188. #define TRUE 1
  189. #define FALSE 0
  190. #endif
  191.  
  192. /* 
  193.  * These could be arbitrary, but its easier to use the actual AIM values 
  194.  */
  195. #define AIM_CONN_TYPE_AUTH          0x0007
  196. #define AIM_CONN_TYPE_ADS           0x0005
  197. #define AIM_CONN_TYPE_BOS           0x0002
  198. #define AIM_CONN_TYPE_CHAT          0x000e
  199. #define AIM_CONN_TYPE_CHATNAV       0x000d
  200.  
  201. /* they start getting arbitrary in rendezvous stuff =) */
  202. #define AIM_CONN_TYPE_RENDEZVOUS    0x0101 /* these do not speak FLAP! */
  203. #define AIM_CONN_TYPE_RENDEZVOUS_OUT 0x0102 /* socket waiting for accept() */
  204.  
  205. /*
  206.  * Subtypes, we need these for OFT stuff.
  207.  */
  208. #define AIM_CONN_SUBTYPE_OFT_DIRECTIM  0x0001
  209. #define AIM_CONN_SUBTYPE_OFT_GETFILE   0x0002
  210. #define AIM_CONN_SUBTYPE_OFT_SENDFILE  0x0003
  211. #define AIM_CONN_SUBTYPE_OFT_BUDDYICON 0x0004
  212. #define AIM_CONN_SUBTYPE_OFT_VOICE     0x0005
  213.  
  214. /*
  215.  * Status values returned from aim_conn_new().  ORed together.
  216.  */
  217. #define AIM_CONN_STATUS_READY       0x0001
  218. #define AIM_CONN_STATUS_INTERNALERR 0x0002
  219. #define AIM_CONN_STATUS_RESOLVERR   0x0040
  220. #define AIM_CONN_STATUS_CONNERR     0x0080
  221. #define AIM_CONN_STATUS_INPROGRESS  0x0100
  222.  
  223. #define AIM_FRAMETYPE_FLAP 0x0000
  224. #define AIM_FRAMETYPE_OFT  0x0001
  225.  
  226. typedef struct aim_conn_s {
  227.     int fd;
  228.     fu16_t type;
  229.     fu16_t subtype;
  230.     flap_seqnum_t seqnum;
  231.     fu32_t status;
  232.     void *priv; /* misc data the client may want to store */
  233.     void *internal; /* internal conn-specific libfaim data */
  234.     time_t lastactivity; /* time of last transmit */
  235.     int forcedlatency; 
  236.     void *handlerlist;
  237.     void *sessv; /* pointer to parent session */
  238.     void *inside; /* only accessible from inside libfaim */
  239.     struct aim_conn_s *next;
  240. } aim_conn_t;
  241.  
  242. /*
  243.  * Byte Stream type. Sort of.
  244.  *
  245.  * Use of this type serves a couple purposes:
  246.  *   - Buffer/buflen pairs are passed all around everywhere. This turns
  247.  *     that into one value, as well as abstracting it slightly.
  248.  *   - Through the abstraction, it is possible to enable bounds checking
  249.  *     for robustness at the cost of performance.  But a clean failure on
  250.  *     weird packets is much better than a segfault.
  251.  *   - I like having variables named "bs".
  252.  *
  253.  * Don't touch the insides of this struct.  Or I'll have to kill you.
  254.  *
  255.  */
  256. typedef struct aim_bstream_s {
  257.     fu8_t *data;
  258.     fu16_t len;
  259.     fu16_t offset;
  260. } aim_bstream_t;
  261.  
  262. typedef struct aim_frame_s {
  263.     fu8_t hdrtype; /* defines which piece of the union to use */
  264.     union {
  265.         struct { 
  266.             fu8_t type;
  267.             flap_seqnum_t seqnum;     
  268.         } flap;
  269.         struct {
  270.             fu16_t type;
  271.             fu8_t magic[4]; /* ODC2 OFT2 */
  272.             fu16_t hdr2len;
  273.             fu8_t *hdr2; /* rest of bloated header */
  274.         } oft;
  275.     } hdr;
  276.     aim_bstream_t data;    /* payload stream */
  277.     fu8_t handled;        /* 0 = new, !0 = been handled */
  278.     fu8_t nofree;        /* 0 = free data on purge, 1 = only unlink */
  279.     aim_conn_t *conn;  /* the connection it came in on... */
  280.     struct aim_frame_s *next;
  281. } aim_frame_t;
  282.  
  283. typedef struct aim_msgcookie_s {
  284.     unsigned char cookie[8];
  285.     int type;
  286.     void *data;
  287.     time_t addtime;
  288.     struct aim_msgcookie_s *next;
  289. } aim_msgcookie_t;
  290.  
  291. /*
  292.  * AIM Session: The main client-data interface.  
  293.  *
  294.  */
  295. typedef struct aim_session_s {
  296.  
  297.     /* ---- Client Accessible ------------------------ */
  298.  
  299.     /* Our screen name. */
  300.     char sn[MAXSNLEN+1];
  301.  
  302.     /*
  303.      * Pointer to anything the client wants to 
  304.      * explicitly associate with this session.
  305.      *
  306.      * This is for use in the callbacks mainly. In any
  307.      * callback, you can access this with sess->aux_data.
  308.      *
  309.      */
  310.     void *aux_data;
  311.  
  312.     /* ---- Internal Use Only ------------------------ */
  313.  
  314.     /* Connection information */
  315.     aim_conn_t *connlist;
  316.  
  317.     /*
  318.      * Transmit/receive queues.
  319.      *
  320.      * These are only used when you don't use your own lowlevel
  321.      * I/O.  I don't suggest that you use libfaim's internal I/O.
  322.      * Its really bad and the API/event model is quirky at best.
  323.      *  
  324.      */
  325.     aim_frame_t *queue_outgoing;   
  326.     aim_frame_t *queue_incoming; 
  327.  
  328.     /*
  329.      * Tx Enqueuing function.
  330.      *
  331.      * This is how you override the transmit direction of libfaim's
  332.      * internal I/O.  This function will be called whenever it needs
  333.      * to send something.
  334.      *
  335.      */
  336.     int (*tx_enqueue)(struct aim_session_s *, aim_frame_t *);
  337.  
  338.     /*
  339.      * This is a dreadful solution to the what-room-are-we-joining
  340.      * problem.  (There's no connection between the service
  341.      * request and the resulting redirect.)
  342.      */ 
  343.     char *pendingjoin;
  344.     fu16_t pendingjoinexchange;
  345.  
  346.     /*
  347.      * Outstanding snac handling 
  348.      *
  349.      * XXX: Should these be per-connection? -mid
  350.      */
  351.     void *snac_hash[FAIM_SNAC_HASH_SIZE];
  352.     aim_snacid_t snacid_next;
  353.  
  354.     struct {
  355.         char server[128];
  356.         char username[128];
  357.         char password[128];
  358.     } socksproxy;
  359.  
  360.     fu32_t flags; /* AIM_SESS_FLAGS_ */
  361.  
  362.     int debug;
  363.     void (*debugcb)(struct aim_session_s *sess, int level, const char *format, va_list va); /* same as faim_debugging_callback_t */
  364.  
  365.     aim_msgcookie_t *msgcookies;
  366.  
  367.     void *modlistv;
  368. } aim_session_t;
  369.  
  370. /* Values for sess->flags */
  371. #define AIM_SESS_FLAGS_SNACLOGIN       0x00000001
  372. #define AIM_SESS_FLAGS_XORLOGIN        0x00000002
  373. #define AIM_SESS_FLAGS_NONBLOCKCONNECT 0x00000004
  374.  
  375. /*
  376.  * AIM User Info, Standard Form.
  377.  */
  378. struct aim_userinfo_s {
  379.     char sn[MAXSNLEN+1];
  380.     fu16_t warnlevel;
  381.     fu16_t idletime;
  382.     fu16_t flags;
  383.     fu32_t membersince;
  384.     fu32_t onlinesince;
  385.     fu32_t sessionlen;  
  386.     fu16_t capabilities;
  387.     struct {
  388.         fu16_t status;
  389.         fu32_t ipaddr;
  390.         fu8_t crap[0x25]; /* until we figure it out... */
  391.     } icqinfo;
  392. };
  393.  
  394. #define AIM_FLAG_UNCONFIRMED     0x0001 /* "damned transients" */
  395. #define AIM_FLAG_ADMINISTRATOR    0x0002
  396. #define AIM_FLAG_AOL        0x0004
  397. #define AIM_FLAG_OSCAR_PAY    0x0008
  398. #define AIM_FLAG_FREE         0x0010
  399. #define AIM_FLAG_AWAY        0x0020
  400. #define AIM_FLAG_UNKNOWN40    0x0040
  401. #define AIM_FLAG_UNKNOWN80    0x0080
  402.  
  403. #define AIM_FLAG_ALLUSERS    0x001f
  404.  
  405.  
  406. #if defined(FAIM_INTERNAL) || defined(FAIM_NEED_TLV)
  407. /*
  408.  * TLV handling
  409.  */
  410.  
  411. /* Generic TLV structure. */
  412. typedef struct aim_tlv_s {
  413.     fu16_t type;
  414.     fu16_t length;
  415.     fu8_t *value;
  416. } aim_tlv_t;
  417.  
  418. /* List of above. */
  419. typedef struct aim_tlvlist_s {
  420.     aim_tlv_t *tlv;
  421.     struct aim_tlvlist_s *next;
  422. } aim_tlvlist_t;
  423.  
  424. /* TLV-handling functions */
  425.  
  426. #if 0
  427. /* Very, very raw TLV handling. */
  428. faim_internal int aim_puttlv_8(fu8_t *buf, const fu16_t t, const fu8_t v);
  429. faim_internal int aim_puttlv_16(fu8_t *buf, const fu16_t t, const fu16_t v);
  430. faim_internal int aim_puttlv_32(fu8_t *buf, const fu16_t t, const fu32_t v);
  431. faim_internal int aim_puttlv_raw(fu8_t *buf, const fu16_t t, const fu16_t l, const fu8_t *v);
  432. #endif
  433.  
  434. /* TLV list handling. */
  435. faim_internal aim_tlvlist_t *aim_readtlvchain(aim_bstream_t *bs);
  436. faim_internal void aim_freetlvchain(aim_tlvlist_t **list);
  437. faim_internal aim_tlv_t *aim_gettlv(aim_tlvlist_t *, fu16_t t, const int n);
  438. faim_internal char *aim_gettlv_str(aim_tlvlist_t *, const fu16_t t, const int n);
  439. faim_internal fu8_t aim_gettlv8(aim_tlvlist_t *list, const fu16_t type, const int num);
  440. faim_internal fu16_t aim_gettlv16(aim_tlvlist_t *list, const fu16_t t, const int n);
  441. faim_internal fu32_t aim_gettlv32(aim_tlvlist_t *list, const fu16_t t, const int n);
  442. faim_internal int aim_writetlvchain(aim_bstream_t *bs, aim_tlvlist_t **list);
  443. faim_internal int aim_addtlvtochain16(aim_tlvlist_t **list, const fu16_t t, const fu16_t v);
  444. faim_internal int aim_addtlvtochain32(aim_tlvlist_t **list, const fu16_t type, const fu32_t v);
  445. faim_internal int aim_addtlvtochain_raw(aim_tlvlist_t **list, const fu16_t t, const fu16_t l, const fu8_t *v);
  446. faim_internal int aim_addtlvtochain_caps(aim_tlvlist_t **list, const fu16_t t, const fu16_t caps);
  447. faim_internal int aim_addtlvtochain_noval(aim_tlvlist_t **list, const fu16_t type);
  448. faim_internal int aim_addtlvtochain_userinfo(aim_tlvlist_t **list, fu16_t type, struct aim_userinfo_s *ui);
  449. faim_internal int aim_addtlvtochain_frozentlvlist(aim_tlvlist_t **list, fu16_t type, aim_tlvlist_t **tl);
  450. faim_internal int aim_counttlvchain(aim_tlvlist_t **list);
  451. faim_internal int aim_sizetlvchain(aim_tlvlist_t **list);
  452. #endif /* FAIM_INTERNAL */
  453.  
  454. /*
  455.  * Get command from connections
  456.  *
  457.  * aim_get_commmand() is the libfaim lowlevel I/O in the receive direction.
  458.  * XXX Make this easily overridable.
  459.  *
  460.  */
  461. faim_export int aim_get_command(aim_session_t *, aim_conn_t *);
  462.  
  463. /*
  464.  * Dispatch commands that are in the rx queue.
  465.  */
  466. faim_export void aim_rxdispatch(aim_session_t *);
  467.  
  468. faim_export int aim_debugconn_sendconnect(aim_session_t *sess, aim_conn_t *conn);
  469.  
  470. faim_export int aim_logoff(aim_session_t *);
  471.  
  472. #if !defined(FAIM_INTERNAL) || defined(FAIM_INTERNAL_INSANE)
  473. /* the library should never call aim_conn_kill */
  474. faim_export void aim_conn_kill(aim_session_t *sess, aim_conn_t **deadconn);
  475. #endif
  476.  
  477. typedef int (*aim_rxcallback_t)(aim_session_t *, aim_frame_t *, ...);
  478.  
  479. /* aim_login.c */
  480. faim_export int aim_sendflapver(aim_session_t *sess, aim_conn_t *conn);
  481. faim_export int aim_request_login(aim_session_t *sess, aim_conn_t *conn, const char *sn);
  482. faim_export int aim_send_login(aim_session_t *, aim_conn_t *, const char *, const char *, struct client_info_s *, const char *key);
  483. faim_export int aim_encode_password_md5(const char *password, const char *key, unsigned char *digest);
  484. faim_export int aim_sendauthresp(aim_session_t *sess, aim_conn_t *conn, const char *sn, int errorcode, const char *errorurl, const char *bosip, const char *cookie, const char *email, int regstatus);
  485. faim_export int aim_gencookie(unsigned char *buf);
  486. faim_export int aim_sendserverready(aim_session_t *sess, aim_conn_t *conn);
  487. faim_export int aim_sendredirect(aim_session_t *sess, aim_conn_t *conn, fu16_t servid, const char *ip, const char *cookie);
  488. faim_export void aim_purge_rxqueue(aim_session_t *);
  489.  
  490. #define AIM_TX_QUEUED    0 /* default */
  491. #define AIM_TX_IMMEDIATE 1
  492. #define AIM_TX_USER      2
  493. faim_export int aim_tx_setenqueue(aim_session_t *sess, int what, int (*func)(aim_session_t *, aim_frame_t *));
  494.  
  495. faim_export int aim_tx_flushqueue(aim_session_t *);
  496. faim_export void aim_tx_purgequeue(aim_session_t *);
  497.  
  498. faim_export int aim_conn_setlatency(aim_conn_t *conn, int newval);
  499.  
  500. faim_export int aim_conn_addhandler(aim_session_t *, aim_conn_t *conn, u_short family, u_short type, aim_rxcallback_t newhandler, u_short flags);
  501. faim_export int aim_clearhandlers(aim_conn_t *conn);
  502.  
  503. faim_export aim_conn_t *aim_conn_findbygroup(aim_session_t *sess, fu16_t group);
  504. faim_export aim_session_t *aim_conn_getsess(aim_conn_t *conn);
  505. faim_export void aim_conn_close(aim_conn_t *deadconn);
  506. faim_export aim_conn_t *aim_newconn(aim_session_t *, int type, const char *dest);
  507. faim_export int aim_conngetmaxfd(aim_session_t *);
  508. faim_export aim_conn_t *aim_select(aim_session_t *, struct timeval *, int *);
  509. faim_export int aim_conn_isready(aim_conn_t *);
  510. faim_export int aim_conn_setstatus(aim_conn_t *, int);
  511. faim_export int aim_conn_completeconnect(aim_session_t *sess, aim_conn_t *conn);
  512. faim_export int aim_conn_isconnecting(aim_conn_t *conn);
  513.  
  514. typedef void (*faim_debugging_callback_t)(aim_session_t *sess, int level, const char *format, va_list va);
  515. faim_export int aim_setdebuggingcb(aim_session_t *sess, faim_debugging_callback_t);
  516. faim_export void aim_session_init(aim_session_t *, unsigned long flags, int debuglevel);
  517. faim_export void aim_session_kill(aim_session_t *);
  518. faim_export void aim_setupproxy(aim_session_t *sess, const char *server, const char *username, const char *password);
  519. faim_export aim_conn_t *aim_getconn_type(aim_session_t *, int type);
  520. faim_export aim_conn_t *aim_getconn_type_all(aim_session_t *, int type);
  521. faim_export aim_conn_t *aim_getconn_fd(aim_session_t *, int fd);
  522.  
  523. /* aim_misc.c */
  524.  
  525. #define AIM_VISIBILITYCHANGE_PERMITADD    0x05
  526. #define AIM_VISIBILITYCHANGE_PERMITREMOVE 0x06
  527. #define AIM_VISIBILITYCHANGE_DENYADD      0x07
  528. #define AIM_VISIBILITYCHANGE_DENYREMOVE   0x08
  529.  
  530. #define AIM_PRIVFLAGS_ALLOWIDLE           0x01
  531. #define AIM_PRIVFLAGS_ALLOWMEMBERSINCE    0x02
  532.  
  533. #define AIM_WARN_ANON                     0x01
  534.  
  535. faim_export int aim_sendpauseack(aim_session_t *sess, aim_conn_t *conn);
  536. faim_export int aim_send_warning(aim_session_t *sess, aim_conn_t *conn, const char *destsn, fu32_t flags);
  537. faim_export int aim_bos_nop(aim_session_t *, aim_conn_t *);
  538. faim_export int aim_flap_nop(aim_session_t *sess, aim_conn_t *conn);
  539. faim_export int aim_bos_setidle(aim_session_t *, aim_conn_t *, fu32_t);
  540. faim_export int aim_bos_changevisibility(aim_session_t *, aim_conn_t *, int, const char *);
  541. faim_export int aim_bos_setbuddylist(aim_session_t *, aim_conn_t *, const char *);
  542. faim_export int aim_bos_setprofile(aim_session_t *sess, aim_conn_t *conn, const char *profile, const char *awaymsg, fu16_t caps);
  543. faim_export int aim_bos_setgroupperm(aim_session_t *, aim_conn_t *, fu32_t mask);
  544. faim_export int aim_bos_clientready(aim_session_t *, aim_conn_t *);
  545. faim_export int aim_bos_reqrate(aim_session_t *, aim_conn_t *);
  546. faim_export int aim_bos_ackrateresp(aim_session_t *, aim_conn_t *);
  547. faim_export int aim_bos_setprivacyflags(aim_session_t *, aim_conn_t *, fu32_t);
  548. faim_export int aim_bos_reqpersonalinfo(aim_session_t *, aim_conn_t *);
  549. faim_export int aim_bos_reqservice(aim_session_t *, aim_conn_t *, fu16_t);
  550. faim_export int aim_bos_reqrights(aim_session_t *, aim_conn_t *);
  551. faim_export int aim_bos_reqbuddyrights(aim_session_t *, aim_conn_t *);
  552. faim_export int aim_bos_reqlocaterights(aim_session_t *, aim_conn_t *);
  553. faim_export int aim_setversions(aim_session_t *sess, aim_conn_t *conn);
  554. faim_export int aim_setdirectoryinfo(aim_session_t *sess, aim_conn_t *conn, const char *first, const char *middle, const char *last, const char *maiden, const char *nickname, const char *street, const char *city, const char *state, const char *zip, int country, fu16_t privacy);
  555. faim_export int aim_setuserinterests(aim_session_t *sess, aim_conn_t *conn, const char *interest1, const char *interest2, const char *interest3, const char *interest4, const char *interest5, fu16_t privacy);
  556. faim_export int aim_icq_setstatus(aim_session_t *sess, aim_conn_t *conn, fu32_t status);
  557.  
  558. faim_export struct aim_fileheader_t *aim_getlisting(aim_session_t *sess, FILE *);
  559.  
  560. #define AIM_CLIENTTYPE_UNKNOWN  0x0000
  561. #define AIM_CLIENTTYPE_MC       0x0001
  562. #define AIM_CLIENTTYPE_WINAIM   0x0002
  563. #define AIM_CLIENTTYPE_WINAIM41 0x0003
  564. #define AIM_CLIENTTYPE_AOL_TOC  0x0004
  565. faim_export unsigned short aim_fingerprintclient(unsigned char *msghdr, int len);
  566.  
  567. #define AIM_RATE_CODE_CHANGE     0x0001
  568. #define AIM_RATE_CODE_WARNING    0x0002
  569. #define AIM_RATE_CODE_LIMIT      0x0003
  570. #define AIM_RATE_CODE_CLEARLIMIT 0x0004
  571. faim_export int aim_ads_clientready(aim_session_t *sess, aim_conn_t *conn);
  572. faim_export int aim_ads_requestads(aim_session_t *sess, aim_conn_t *conn);
  573.  
  574. /* aim_im.c */
  575.  
  576. struct aim_fileheader_t {
  577. #if 0
  578.     char  magic[4];        /* 0 */
  579.     short hdrlen;         /* 4 */
  580.     short hdrtype;        /* 6 */
  581. #endif
  582.     char  bcookie[8];       /* 8 */
  583.     short encrypt;          /* 16 */
  584.     short compress;         /* 18 */
  585.     short totfiles;         /* 20 */
  586.     short filesleft;        /* 22 */
  587.     short totparts;         /* 24 */
  588.     short partsleft;        /* 26 */
  589.     long  totsize;          /* 28 */
  590.     long  size;             /* 32 */
  591.     long  modtime;          /* 36 */
  592.     long  checksum;         /* 40 */
  593.     long  rfrcsum;          /* 44 */
  594.     long  rfsize;           /* 48 */
  595.     long  cretime;          /* 52 */
  596.     long  rfcsum;           /* 56 */
  597.     long  nrecvd;           /* 60 */
  598.     long  recvcsum;         /* 64 */
  599.     char  idstring[32];     /* 68 */
  600.     char  flags;            /* 100 */
  601.     char  lnameoffset;      /* 101 */
  602.     char  lsizeoffset;      /* 102 */
  603.     char  dummy[69];        /* 103 */
  604.     char  macfileinfo[16];  /* 172 */
  605.     short nencode;          /* 188 */
  606.     short nlanguage;        /* 190 */
  607.     char  name[64];         /* 192 */
  608.                 /* 256 */
  609. };
  610.  
  611. struct aim_filetransfer_priv {
  612.     char sn[MAXSNLEN];
  613.     char cookie[8];
  614.     char ip[30];
  615.     int state;
  616.     struct aim_fileheader_t fh;
  617. };
  618.  
  619. struct aim_chat_roominfo {
  620.     unsigned short exchange;
  621.     char *name;
  622.     unsigned short instance;
  623. };
  624.  
  625. #define AIM_IMFLAGS_AWAY        0x0001 /* mark as an autoreply */
  626. #define AIM_IMFLAGS_ACK            0x0002 /* request a receipt notice */
  627. #define AIM_IMFLAGS_UNICODE        0x0004
  628. #define AIM_IMFLAGS_ISO_8859_1        0x0008
  629. #define AIM_IMFLAGS_BUDDYREQ        0x0010 /* buddy icon requested */
  630. #define AIM_IMFLAGS_HASICON        0x0020 /* already has icon */
  631. #define AIM_IMFLAGS_SUBENC_MACINTOSH    0x0040 /* damn that Steve Jobs! */
  632. #define AIM_IMFLAGS_CUSTOMFEATURES     0x0080 /* features field present */
  633. #define AIM_IMFLAGS_EXTDATA        0x0100
  634. #define AIM_IMFLAGS_CUSTOMCHARSET    0x0200 /* charset fields set */
  635. #define AIM_IMFLAGS_MULTIPART        0x0400 /* ->mpmsg section valid */
  636.  
  637. /*
  638.  * Multipart message structures.
  639.  */
  640. typedef struct aim_mpmsg_section_s {
  641.     fu16_t charset;
  642.     fu16_t charsubset;
  643.     fu8_t *data;
  644.     fu16_t datalen;
  645.     struct aim_mpmsg_section_s *next;
  646. } aim_mpmsg_section_t;
  647.  
  648. typedef struct aim_mpmsg_s {
  649.     int numparts;
  650.     aim_mpmsg_section_t *parts;
  651. } aim_mpmsg_t;
  652.  
  653. faim_export int aim_mpmsg_init(aim_session_t *sess, aim_mpmsg_t *mpm);
  654. faim_export int aim_mpmsg_addraw(aim_session_t *sess, aim_mpmsg_t *mpm, fu16_t charset, fu16_t charsubset, const fu8_t *data, fu16_t datalen);
  655. faim_export int aim_mpmsg_addascii(aim_session_t *sess, aim_mpmsg_t *mpm, const char *ascii);
  656. faim_export int aim_mpmsg_addunicode(aim_session_t *sess, aim_mpmsg_t *mpm, const fu16_t *unicode, fu16_t unicodelen);
  657. faim_export void aim_mpmsg_free(aim_session_t *sess, aim_mpmsg_t *mpm);
  658.  
  659. /*
  660.  * Arguments to aim_send_im_ext().
  661.  *
  662.  * This is really complicated.  But immensely versatile.
  663.  *
  664.  */
  665. struct aim_sendimext_args {
  666.  
  667.     /* These are _required_ */
  668.     const char *destsn;
  669.     fu32_t flags; /* often 0 */
  670.  
  671.     /* Only required if not using multipart messages */
  672.     const char *msg;
  673.     int msglen;
  674.  
  675.     /* Required if ->msg is not provided */
  676.     aim_mpmsg_t *mpmsg;
  677.  
  678.     /* Only used if AIM_IMFLAGS_HASICON is set */
  679.     fu32_t iconlen;
  680.     time_t iconstamp;
  681.     fu32_t iconsum;
  682.  
  683.     /* Only used if AIM_IMFLAGS_CUSTOMFEATURES is set */
  684.     fu8_t *features;
  685.     fu8_t featureslen;
  686.  
  687.     /* Only used if AIM_IMFLAGS_CUSTOMCHARSET is set and mpmsg not used */
  688.     fu16_t charset;
  689.     fu16_t charsubset;
  690. };
  691.  
  692. /*
  693.  * This information is provided in the Incoming ICBM callback for
  694.  * Channel 1 ICBM's.  
  695.  *
  696.  * Note that although CUSTOMFEATURES and CUSTOMCHARSET say they
  697.  * are optional, both are always set by the current libfaim code.
  698.  * That may or may not change in the future.  It is mainly for
  699.  * consistency with aim_sendimext_args.
  700.  *
  701.  * Multipart messages require some explanation. If you want to use them,
  702.  * I suggest you read all the comments in im.c.
  703.  *
  704.  */
  705. struct aim_incomingim_ch1_args {
  706.  
  707.     /* Always provided */
  708.     aim_mpmsg_t mpmsg;
  709.     fu32_t icbmflags; /* some flags apply only to ->msg, not all mpmsg */
  710.     
  711.     /* Only provided if message has a human-readable section */
  712.     char *msg;
  713.     int msglen;
  714.  
  715.     /* Only provided if AIM_IMFLAGS_HASICON is set */
  716.     time_t iconstamp;
  717.     fu32_t iconlen;
  718.     fu32_t iconsum;
  719.  
  720.     /* Only provided if AIM_IMFLAGS_CUSTOMFEATURES is set */
  721.     fu8_t *features;
  722.     fu8_t featureslen;
  723.  
  724.     /* Only provided if AIM_IMFLAGS_EXTDATA is set */
  725.     fu8_t extdatalen;
  726.     fu8_t *extdata;
  727.  
  728.     /* Only used if AIM_IMFLAGS_CUSTOMCHARSET is set */
  729.     fu16_t charset;
  730.     fu16_t charsubset;
  731. };
  732.  
  733. struct aim_incomingim_ch2_args {
  734.     fu8_t cookie[8];
  735.     fu16_t reqclass;
  736.     fu16_t status;
  737.     union {
  738.         struct {
  739.             fu32_t checksum;
  740.             fu32_t length;
  741.             time_t timestamp;
  742.             fu8_t *icon;
  743.         } icon;
  744.         struct {
  745.         } voice;
  746.         struct {
  747.             fu8_t ip[22]; /* xxx.xxx.xxx.xxx:xxxxx\0 */
  748.         } imimage;
  749.         struct {
  750.             char *msg;
  751.             char *encoding;
  752.             char *lang;
  753.         struct aim_chat_roominfo roominfo;
  754.         } chat;
  755.         struct {
  756.             char *ip;
  757.             unsigned char *cookie;
  758.         } getfile;
  759.         struct {
  760.         } sendfile;
  761.     } info;
  762. };
  763.  
  764. faim_export int aim_send_im_ext(aim_session_t *sess, aim_conn_t *conn, struct aim_sendimext_args *args);
  765. faim_export int aim_send_im(aim_session_t *, aim_conn_t *, const char *destsn, unsigned short flags, const char *msg);
  766. faim_export int aim_send_icon(aim_session_t *sess, aim_conn_t *conn, const char *sn, const fu8_t *icon, int iconlen, time_t stamp, fu32_t iconsum);
  767. faim_export fu32_t aim_iconsum(const fu8_t *buf, int buflen);
  768. faim_export int aim_send_im_direct(aim_session_t *, aim_conn_t *, const char *msg);
  769. faim_export const char *aim_directim_getsn(aim_conn_t *conn);
  770. faim_export aim_conn_t *aim_directim_initiate(aim_session_t *, aim_conn_t *, const char *destsn);
  771. faim_export aim_conn_t *aim_directim_connect(aim_session_t *, const char *sn, const char *addr, const fu8_t *cookie);
  772.  
  773. faim_export aim_conn_t *aim_getfile_initiate(aim_session_t *sess, aim_conn_t *conn, const char *destsn);
  774. faim_export int aim_oft_getfile_request(aim_session_t *sess, aim_conn_t *conn, const char *name, int size);
  775. faim_export int aim_oft_getfile_ack(aim_session_t *sess, aim_conn_t *conn);
  776. faim_export int aim_oft_getfile_end(aim_session_t *sess, aim_conn_t *conn);
  777.  
  778. /* aim_info.c */
  779. #define AIM_CAPS_BUDDYICON      0x0001
  780. #define AIM_CAPS_VOICE          0x0002
  781. #define AIM_CAPS_IMIMAGE        0x0004
  782. #define AIM_CAPS_CHAT           0x0008
  783. #define AIM_CAPS_GETFILE        0x0010
  784. #define AIM_CAPS_SENDFILE       0x0020
  785. #define AIM_CAPS_GAMES          0x0040
  786. #define AIM_CAPS_SAVESTOCKS     0x0080
  787. #define AIM_CAPS_SENDBUDDYLIST  0x0100
  788. #define AIM_CAPS_GAMES2         0x0200
  789. #define AIM_CAPS_LAST           0x8000
  790.  
  791. faim_export int aim_0002_000b(aim_session_t *sess, aim_conn_t *conn, const char *sn);
  792.  
  793. #define AIM_SENDMEMBLOCK_FLAG_ISREQUEST  0
  794. #define AIM_SENDMEMBLOCK_FLAG_ISHASH     1
  795.  
  796. faim_export int aim_sendmemblock(aim_session_t *sess, aim_conn_t *conn, unsigned long offset, unsigned long len, const unsigned char *buf, unsigned char flag);
  797.  
  798. #define AIM_GETINFO_GENERALINFO 0x00001
  799. #define AIM_GETINFO_AWAYMESSAGE 0x00003
  800.  
  801. struct aim_invite_priv {
  802.     char *sn;
  803.     char *roomname;
  804.     fu16_t exchange;
  805.     fu16_t instance;
  806. };
  807.  
  808. #define AIM_COOKIETYPE_UNKNOWN  0x00
  809. #define AIM_COOKIETYPE_ICBM     0x01
  810. #define AIM_COOKIETYPE_ADS      0x02
  811. #define AIM_COOKIETYPE_BOS      0x03
  812. #define AIM_COOKIETYPE_IM       0x04
  813. #define AIM_COOKIETYPE_CHAT     0x05
  814. #define AIM_COOKIETYPE_CHATNAV  0x06
  815. #define AIM_COOKIETYPE_INVITE   0x07
  816. /* we'll move OFT up a bit to give breathing room.  not like it really
  817.  * matters. */
  818. #define AIM_COOKIETYPE_OFTIM    0x10
  819. #define AIM_COOKIETYPE_OFTGET   0x11
  820. #define AIM_COOKIETYPE_OFTSEND  0x12
  821. #define AIM_COOKIETYPE_OFTVOICE 0x13
  822. #define AIM_COOKIETYPE_OFTIMAGE 0x14
  823. #define AIM_COOKIETYPE_OFTICON  0x15
  824.  
  825. faim_export int aim_handlerendconnect(aim_session_t *sess, aim_conn_t *cur);
  826.  
  827. #define AIM_TRANSFER_DENY_NOTSUPPORTED 0x0000
  828. #define AIM_TRANSFER_DENY_DECLINE 0x0001
  829. #define AIM_TRANSFER_DENY_NOTACCEPTING 0x0002
  830. faim_export int aim_denytransfer(aim_session_t *sess, aim_conn_t *conn, const char *sender, const char *cookie, unsigned short code);
  831. faim_export aim_conn_t *aim_accepttransfer(aim_session_t *sess, aim_conn_t *conn, const char *sn, const fu8_t *cookie, const fu8_t *ip, fu16_t listingfiles, fu16_t listingtotsize, fu16_t listingsize, fu32_t listingchecksum, fu16_t rendid);
  832.  
  833. faim_export int aim_getinfo(aim_session_t *, aim_conn_t *, const char *, unsigned short);
  834. faim_export int aim_sendbuddyoncoming(aim_session_t *sess, aim_conn_t *conn, struct aim_userinfo_s *info);
  835. faim_export int aim_sendbuddyoffgoing(aim_session_t *sess, aim_conn_t *conn, const char *sn);
  836.  
  837. #define AIM_IMPARAM_FLAG_CHANMSGS_ALLOWED    0x00000001
  838. #define AIM_IMPARAM_FLAG_MISSEDCALLS_ENABLED    0x00000002
  839.  
  840. /* This is what the server will give you if you don't set them yourself. */
  841. #define AIM_IMPARAM_DEFAULTS { \
  842.     0, \
  843.     AIM_IMPARAM_FLAG_CHANMSGS_ALLOWED | AIM_IMPARAM_FLAG_MISSEDCALLS_ENABLED, \
  844.     512, /* !! Note how small this is. */ \
  845.     (99.9)*10, (99.9)*10, \
  846.     1000 \
  847. }
  848.  
  849. /* This is what most AIM versions use. */
  850. #define AIM_IMPARAM_REASONABLE { \
  851.     0, \
  852.     AIM_IMPARAM_FLAG_CHANMSGS_ALLOWED | AIM_IMPARAM_FLAG_MISSEDCALLS_ENABLED, \
  853.     8000, \
  854.     (99.9)*10, (99.9)*10, \
  855.     0 \
  856. }
  857.  
  858.  
  859. struct aim_icbmparameters {
  860.     unsigned short maxchan;
  861.     unsigned long flags; /* AIM_IMPARAM_FLAG_ */
  862.     unsigned short maxmsglen; /* message size that you will accept */
  863.     unsigned short maxsenderwarn; /* this and below are *10 (999=99.9%) */
  864.     unsigned short maxrecverwarn;
  865.     unsigned long minmsginterval; /* in milliseconds? */
  866. };
  867.  
  868. faim_export int aim_reqicbmparams(aim_session_t *sess, aim_conn_t *conn);
  869. faim_export int aim_seticbmparam(aim_session_t *sess, aim_conn_t *conn, struct aim_icbmparameters *params);
  870.  
  871.  
  872. /* auth.c */
  873. faim_export int aim_auth_sendcookie(aim_session_t *, aim_conn_t *, const fu8_t *);
  874.  
  875. faim_export int aim_auth_clientready(aim_session_t *, aim_conn_t *);
  876. faim_export int aim_auth_changepasswd(aim_session_t *, aim_conn_t *, const char *newpw, const char *curpw);
  877. faim_export int aim_auth_setversions(aim_session_t *sess, aim_conn_t *conn);
  878. faim_export int aim_auth_reqconfirm(aim_session_t *sess, aim_conn_t *conn);
  879. faim_export int aim_auth_getinfo(aim_session_t *sess, aim_conn_t *conn, fu16_t info);
  880. faim_export int aim_auth_setemail(aim_session_t *sess, aim_conn_t *conn, const char *newemail);
  881.  
  882. /* aim_buddylist.c */
  883. faim_export int aim_add_buddy(aim_session_t *, aim_conn_t *, const char *);
  884. faim_export int aim_remove_buddy(aim_session_t *, aim_conn_t *, const char *);
  885.  
  886. /* aim_search.c */
  887. faim_export int aim_usersearch_address(aim_session_t *, aim_conn_t *, const char *);
  888.  
  889. struct aim_chat_exchangeinfo {
  890.     fu16_t number;
  891.     char *name;
  892.     char *charset1;
  893.     char *lang1;
  894.     char *charset2;
  895.     char *lang2;
  896. };
  897.  
  898. #define AIM_CHATFLAGS_NOREFLECT 0x0001
  899. #define AIM_CHATFLAGS_AWAY      0x0002
  900. faim_export int aim_chat_send_im(aim_session_t *sess, aim_conn_t *conn, fu16_t flags, const char *msg, int msglen);
  901. faim_export int aim_chat_join(aim_session_t *sess, aim_conn_t *conn, fu16_t exchange, const char *roomname, fu16_t instance);
  902. faim_export int aim_chat_clientready(aim_session_t *sess, aim_conn_t *conn);
  903. faim_export int aim_chat_attachname(aim_conn_t *conn, const char *roomname);
  904. faim_export char *aim_chat_getname(aim_conn_t *conn);
  905. faim_export aim_conn_t *aim_chat_getconn(aim_session_t *, const char *name);
  906.  
  907. faim_export int aim_chatnav_reqrights(aim_session_t *sess, aim_conn_t *conn);
  908. faim_export int aim_chatnav_clientready(aim_session_t *sess, aim_conn_t *conn);
  909.  
  910. faim_export int aim_chat_invite(aim_session_t *sess, aim_conn_t *conn, const char *sn, const char *msg, fu16_t exchange, const char *roomname, fu16_t instance);
  911.  
  912. faim_export int aim_chatnav_createroom(aim_session_t *sess, aim_conn_t *conn, const char *name, fu16_t exchange);
  913. faim_export int aim_chat_leaveroom(aim_session_t *sess, const char *name);
  914.  
  915. /* aim_util.c */
  916. /*
  917.  * These are really ugly.  You'd think this was LISP.  I wish it was.
  918.  *
  919.  * XXX With the advent of bstream's, these should be removed to enforce
  920.  * their use.
  921.  *
  922.  */
  923. #define aimutil_put8(buf, data) ((*(buf) = (u_char)(data)&0xff),1)
  924. #define aimutil_get8(buf) ((*(buf))&0xff)
  925. #define aimutil_put16(buf, data) ( \
  926.         (*(buf) = (u_char)((data)>>8)&0xff), \
  927.         (*((buf)+1) = (u_char)(data)&0xff),  \
  928.         2)
  929. #define aimutil_get16(buf) ((((*(buf))<<8)&0xff00) + ((*((buf)+1)) & 0xff))
  930. #define aimutil_put32(buf, data) ( \
  931.         (*((buf)) = (u_char)((data)>>24)&0xff), \
  932.         (*((buf)+1) = (u_char)((data)>>16)&0xff), \
  933.         (*((buf)+2) = (u_char)((data)>>8)&0xff), \
  934.         (*((buf)+3) = (u_char)(data)&0xff), \
  935.         4)
  936. #define aimutil_get32(buf) ((((*(buf))<<24)&0xff000000) + \
  937.         (((*((buf)+1))<<16)&0x00ff0000) + \
  938.         (((*((buf)+2))<< 8)&0x0000ff00) + \
  939.         (((*((buf)+3)    )&0x000000ff)))
  940.  
  941. faim_export int aimutil_putstr(u_char *, const char *, int);
  942. faim_export int aimutil_tokslen(char *toSearch, int index, char dl);
  943. faim_export int aimutil_itemcnt(char *toSearch, char dl);
  944. faim_export char *aimutil_itemidx(char *toSearch, int index, char dl);
  945.  
  946. faim_export int aim_snlen(const char *sn);
  947. faim_export int aim_sncmp(const char *sn1, const char *sn2);
  948.  
  949. /* for libc's that dont have it */
  950. faim_export char *aim_strsep(char **pp, const char *delim);
  951.  
  952. /* aim_meta.c */
  953. faim_export char *aim_getbuilddate(void);
  954. faim_export char *aim_getbuildtime(void);
  955. faim_export int aim_getbuildstring(char *buf, int buflen);
  956.  
  957. #include <aim_internal.h>
  958.  
  959. #endif /* __AIM_H__ */
  960.  
  961.